home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1999 July: Mac OS SDK / Dev.CD Jul 99 SDK1.toast / Development Kits / Mac OS / Interfaces&Libraries / Documentation / 3.2 Release Notes < prev    next >
Encoding:
Text File  |  1998-08-18  |  9.2 KB  |  345 lines  |  [TEXT/MPS ]
  1. ==============================================
  2. Universal Interfaces & Libraries Release Notes 
  3. ==============================================
  4.  
  5. Version: Universal Interfaces 3.2
  6. Date:    August 18, 1998
  7. Author:  Nick Kledzik
  8.  
  9.  
  10. =================
  11. Important Notice
  12. =================
  13.  
  14. The 3.2 Universal Interfaces contain Beta headers for 
  15. Allegro (Mac OS 8.5).  There is a slight chance that some
  16. of the new Allegro API's may change before Allegro ships.
  17. If you use any of the new Allegro API's, be sure to test 
  18. your code on Mac OS 8.5 final before shipping your product.
  19.  
  20.  
  21. ==========================================
  22. New Features in Universal Interfaces 3.2
  23. ==========================================
  24.  
  25. -    Latest interfaces and stub libraries for:
  26.         Mac OS 8.5 (late beta)
  27.         QuickTime 3.0 
  28.         NavServices
  29.         TEC 1.4
  30.     
  31. -    New files:
  32.         ATSLayoutTypes.h
  33.         ATSUnicode.h
  34.         Navigation.h
  35.         QD3DCustomElements.h
  36.         RAVE.h
  37.         RAVESystem.h
  38.         UnicodeUtilities.h
  39.  
  40.  
  41. ==================================================
  42. Bug Fixes and Changes in Universal Interfaces 3.2
  43. ==================================================
  44.  
  45.     AERegistry.h
  46.         Added support for unit coercions, Connectivity, and Internet suites
  47.     
  48.     Aliases.h
  49.         Add IsAliasFile() and ResolveAliasWithMountFlags() for Mac OS 8.5
  50.     
  51.     Appearance.h
  52.         Updated to include Appearance 1.1 API's
  53.         
  54.     ASRegistry.h
  55.         Update for AppleScript 1.3
  56.         
  57.     ATA.h
  58.         Add support for Ultra DMA mode.
  59.         
  60.     ATSLayoutTypes.h
  61.     ATSUnicode.h
  62.         New file for Mac OS 8.5
  63.         
  64.     AVComponents.h
  65.         Change itemOffset from a short to the long.
  66.         
  67.     Balloons.p
  68.         Change VAR Rect to RectPtr for pascal
  69.         
  70.     CodeFragments.r
  71.         Change cfrg template to derez version fields in hex instead of decimal
  72.         
  73.     Controls.h
  74.         Update for new API's in Mac OS 8.5
  75.         
  76.     Dialogs.h
  77.         Fix macros to not use implicit casts (for Pro4).
  78.         
  79.     DigitalSignature.h
  80.         Change uses of SIGStatusProcPtr to SIGStatusUPP
  81.         
  82.     DiskInit.h
  83.         Change DIBadMount to take UInt32 instead of long
  84.         
  85.     Displays.h
  86.         Add DMMakeAndModelRec struct.
  87.         
  88.     Drag.h
  89.         Remove spurious DragImageTranslucency typedef.
  90.         
  91.     DriverGestalt.h
  92.         Add drive icon suite functionality for Mac OS 8.5
  93.         
  94.     DriveServices.h
  95.         Add kPageInformationVersion comment.  Add kPageIsHeldResident
  96.         
  97.     Errors.h
  98.         Update with latest error codes.
  99.         
  100.     Events.h
  101.         Change KeyMap back to UInt32 array from long array.
  102.         
  103.     Files.h
  104.         Add fsRdDenyPerm and fsWrDenyPerm.  Add PBHTrashVolumeCachesSync().
  105.  
  106.     FindByContent.h
  107.         New file for Mac OS 8.5
  108.     
  109.     Finder.h
  110.         Add ExtendedFileInfo and ExtendedFolderInfo structs for new Finder info.
  111.         
  112.     Folders.h
  113.         Add new folder constants for Mac OS 8.5
  114.         
  115.     Fonts.h
  116.         Add routines for enabling anti-aliased fonts.
  117.         
  118.     fp.h
  119.         Fix comments. Make compatible with latest MSL.
  120.         
  121.     FSM.h
  122.         Moved some declarations to Files.h
  123.         
  124.     Gestalt.h
  125.         Add latest Gestalt selectors.
  126.         
  127.     HFSVolumes.h
  128.         Minor tweaks
  129.         
  130.     Icons.h
  131.         Add new IconRef based API's for Mac OS 8.5
  132.         
  133.     ImageCodec.h
  134.     ImageCompression.h
  135.         Updated to QuickTime 3.0 final headers.
  136.         
  137.     InputSprockets.r
  138.         New file for InputSprockets 1.3
  139.         
  140.     IntlResources.h
  141.         Add itlcDisableKeyScriptSync constant.
  142.         
  143.     JManager.h
  144.         Fix JMGetCurrentJRIEnv to be in JRI_H not JNI_H. Rename some parameters.
  145.         
  146.     LowMem.h
  147.         Add KeyTime and MBTicks.  Add LMGetFinderName for pascal.
  148.         
  149.     MachineExceptions.h
  150.         Add AltiVec support.
  151.         
  152.     MacTypes.h
  153.         Fix comments.  Add ConstStringPtr.
  154.     
  155.     MacWindows.h
  156.         Update for new API's in Mac OS 8.5
  157.     
  158.     Menus.h
  159.         Update for new API's in Mac OS 8.5
  160.         
  161.     MixedMode.h
  162.         Updated comment about how to put PEF in a resource.
  163.     
  164.     Movies.h
  165.         Updated to QuickTime 3.0 final headers.
  166.     
  167.     Navigation.h
  168.         Fold NavFileOrFolderInfo into one struct.
  169.         
  170.     OSUtils.h
  171.         FlushCodeCacheRange now callable from PowerPC. 
  172.         
  173.     Palettes.h
  174.         Add back pmDithered.
  175.         
  176.     PCCard.h
  177.         Add USB and Firewire contorller types.
  178.         
  179.     PEFBinaryFormat.h
  180.         Update for PEF2.
  181.         
  182.     Printing.h
  183.         Fix TPPRPortRef and TPPrStatusRef for pascal.
  184.     
  185.     QD3D.h
  186.     QD3DCustomElements.h
  187.     QD3DMath.h
  188.     QD3DRenderer.h
  189.     QD3DSet.h
  190.     QD3DTransform.h
  191.     QD3DView.h
  192.     QD3DViewer.h
  193.     RAVE.h
  194.     RAVESystem.h
  195.         Update to QD3D 1.5.4 headers.
  196.         
  197.     QDOffscreen.h
  198.         Add GetPixRowBytes()
  199.     
  200.     QTML.h
  201.         Update for QuickTime 3.0 final headers.
  202.     
  203.     Quickdraw.h
  204.         GDevice.gdNextGD is now a GDHandle. 
  205.         
  206.     QuickTimeComponents.h
  207.         Update for QuickTime 3.0 final headers.
  208.  
  209.     Script.h
  210.         Add constants for Greenland.
  211.         
  212.     SFNTLayoutTypes.h
  213.         Change property table version to 2.0.
  214.         
  215.     SFNTTypes.h
  216.         Add FontNameCode.
  217.         
  218.     Sound.h
  219.         Add kSoundInSource.  Add support for getting siRecordingQuality.
  220.         
  221.     TextCommon.h
  222.         Updates for MacOS 8.5
  223.         
  224.     TextEdit.h
  225.         Fix TEGetScrapLength to only be defined for classic 68k.
  226.         
  227.     TextServices.h
  228.         Add TextServiceProperty routines.
  229.         
  230.     UnicodeConverter.r
  231.         New Rez file.
  232.         
  233.     UnicodeUtilities.h
  234.         New interface for Mac OS 8.5
  235.         
  236.     Video.h
  237.         Add bits for determing in sleep is OK on powerbooks.
  238.     
  239.     VideoServices.h
  240.         Add VSLSetDisplayConfiguration().
  241.         
  242.             
  243.  
  244. ========================================
  245. Bug Fixes and Changes in Stub Libraries
  246. ========================================
  247.  
  248. -    New Stub Libraries for Allegro:
  249.         ATSUnicodeLib
  250.         ControlsLib
  251.         DialogsLib
  252.         FindByContent
  253.         FontManager
  254.         IconServicesLib
  255.         MenusLib
  256.         UnicodeUtilitiesLib
  257.         WindowsLib
  258.  
  259. -    Updated Stub Libraries for Allegro:
  260.         InterfaceLib
  261.         AppearanceLib
  262.         
  263. -    Stub Libraries previously on separate SDK's:
  264.         ContextualMenu
  265.         InputSprockets
  266.         NavigationLib
  267.         TextCommon
  268.         TextEncodingConverter
  269.         UnicodeConverter
  270.         ColorPickerLib
  271.         QuickTimeLib
  272.         SoundLib
  273.  
  274. -    NOTE: the new InterfaceLib stub library contains a number of additional
  275.     routines available only in Mac OS 8.5.  If you use any of the new routines,
  276.     and want to run on pre 8.5 systems, you must weak link against InterfaceLib
  277.     and then not call any of the new routines when running on pre 8.5 systems.
  278.  
  279. -     The following routines were added to InterfaceLib in System 7.5
  280.         FTCompletionAsync, FTReceiveAsync, FTSendAsync
  281.         DeleteGestaltValue, NewGestaltValue, SetGestaltValue, ReplaceGestaltValue
  282.  
  283. -     The following routines were added to InterfaceLib in Mac OS 8.5
  284.         PBXGetVolInfoSync, PBXGetVolInfoAsync, PBGetXCatInfoSync, PBGetXCatInfoAsync,
  285.         LMGetCursorNew, LMSetCursorNew, LMGetMouseButtonState, LMSetMouseButtonState,
  286.         LMGetMouseTemp, LMSetMouseTemp, LMGetRawMouseLocation, LMSetRawMouseLocation,
  287.         LMGetMouseLocation, LMSetMouseLocation, LMGetTheCursor, LMSetTheCursor,
  288.         LMGetHighHeapMark, LMSetHighHeapMark, LMGetStackLowPoint, LMSetStackLowPoint,
  289.         LMGetROMMapHandle, LMSetROMMapHandle, LMGetUnitTableEntryCount, LMSetUnitTableEntryCount,
  290.         LMGetDiskFormatingHFSDefaults, LMSetDiskFormatingHFSDefaults,
  291.         LMGetPortAInfo, LMSetPortAInfo, LMGetABusGlobals, LMSetABusGlobals, 
  292.         LMGetABusDCE, LMSetABusDCE, LMGetKeyTime, LMSetKeyTime, LMGetMBTicks, LMSetMBTicks,
  293.         IsAliasFile, ResolveAliasWithMountFlags, ResolveAliasFileWithMountFlags, 
  294.         DriverInstall, DriverInstallReserveMem, DIXFormat, DIXZero, DIReformat,
  295.         PBUnmountVolImmed, ReallocateHandleSys, LockMemoryForOutput, MakeMemoryResident,
  296.         ReleaseMemoryData, MakeMemoryNonResident, FlushMemory,
  297.         InstallExtensionNotificationProc, RemoveExtensionNotificationProc,
  298.         InstallExtensionTableHandlerProc, RemoveExtensionTableHandlerProc,
  299.         FlushCodeCacheRange, NewCServiceWindow, UCTextServiceEvent, ataManager,
  300.         PurgeSpaceTotal, PurgeSpaceContiguous, PurgeSpaceSysTotal, PurgeSpaceSysContiguous,,
  301.         UTAllocateFCB, UTReleaseFCB, UTLocateFCB, UTLocateNextFCB, UTIndexFCB, UTResolveFCB,
  302.         UTAllocateVCB, UTAddNewVCB, UTDisposeVCB, UTLocateVCBByRefNum, UTLocateVCBByName, 
  303.         UTLocateNextVCB, UTAllocateWDCB, UTReleaseWDCB, UTResolveWDCB, UTFindDrive, UTAdjustEOF,
  304.         UTSetDefaultVol, UTGetDefaultVol, UTEjectVol, UTCheckWDRefNum, UTCheckFileRefNum, 
  305.         UTCheckVolRefNum, UTCheckPermission, UTCheckVolOffline, UTCheckVolModifiable, 
  306.         UTCheckFileModifiable, UTCheckDirBusy, UTParsePathname, UTGetPathComponentName, 
  307.         UTDetermineVol, UTGetBlock, UTReleaseBlock, UTFlushCache, UTMarkDirty, UTTrashVolBlocks,
  308.         UTTrashFileBlocks, UTTrashBlocks, UTCacheReadIP, UTCacheWriteIP, UTBlockInFQHashP, 
  309.         UTVolCacheReadIP, UTVolCacheWriteIP, InstallFS, RemoveFS, 
  310.         SetFSInfo, GetFSInfo, InformFSM, InformFFS, 
  311.         IncrementAtomic, DecrementAtomic, AddAtomic, BitAndAtomic, BitOrAtomic, BitXorAtomic
  312.         CompareAndSwap, IncrementAtomic8, DecrementAtomic8, AddAtomic8, BitAndAtomic8, BitOrAtomic8,
  313.         BitXorAtomic8, IncrementAtomic16, DecrementAtomic16, AddAtomic16, BitAndAtomic16, 
  314.         BitOrAtomic16, BitXorAtomic16, TestAndSet, TestAndClear,
  315.         BlockMoveDataUncached, BlockMoveUncached, BlockZero, BlockZeroUncached
  316.  
  317.  
  318. ==========================
  319. Known Bugs and Limitations
  320. ==========================
  321.  
  322. -    Some of the newer stub libraries have the usage field
  323.     in the cfrg resource set to 3 instead of 0.  This 
  324.     specifies the fragment is a stub and does not contain
  325.     code.  All CodeWarrior linkers handle this, but older
  326.     PPCLink tools will ignore the fragment and issue a 
  327.     warning.  You should update to a newer PPCLink because
  328.     this will become the standard way stub libraries are 
  329.     built.
  330.  
  331. -    CodeWarrior Pro4 has made changes to MSL to conform with
  332.     the evolving C9X standard.  The changes conflict with
  333.     fp.h.  If you are using the 3.2 headers, Pro4, MSL, fp.h, 
  334.     and are getting compiler errors, update your fp.h to be 
  335.     the one from Pro4.  It has been modified by Metrowerks
  336.     to be compatible with their latest MSL.
  337.     
  338.  
  339. -------------------------------------------------------------------------
  340. Nick Kledzik
  341. Universal Interfaces 
  342. Apple Computer, Inc.
  343.  
  344.  
  345.